<?php
/**
 * licenses : MIT
 * creatTime: 2020/5/15
 * author : weblinuxgame
 * filename: UserApi.php
 */

namespace App\Api\Modules\User\Admin;

use Illuminate\Http\Request;
use Illuminate\Http\Response;
use OpenApi\Annotations as OA;

/**
 * @OA\Tag(
 *    name="UserManager",
 *    description="## 管理后台-用户管理接口集合",
 *   )
 */

/**
 * Interface UserApi
 * @package App\Api\Modules\User
 */
interface UserApi
{
    /**
     * 罗列app用户
     * @param Request $request
     * @return Response
     */
    public function lists(Request $request): Response;

    /**
     * 展示单个用户详细信息
     * @param Request $request
     * @return Response
     */
    public function show(Request $request): Response;

    /**
     * 查询用户信息
     * @param Request $request
     * @return Response
     */
    public function search(Request $request): Response;

    /**
     * 禁用用户接口
     * @param Request $request
     * @return Response
     */
    public function forbid(Request $request): Response;

    /**
     * 解封用户接口
     * @param Request $request
     * @return Response
     */
    public function allow(Request $request): Response;

    /**
     * 罗列禁用用户列表
     * @param Request $request
     * @return Response
     */
    public function listsForbids(Request $request): Response;

}
